FACE_ENG %Programdocumentation for faceVALUE Title Contents Introduction Tutorial faceVALUE principles faceVALUE program dialogs Menu bar Dialog 'Main' User window flags About Face Value System alerts System requirements Rsc information Parameters-Dialog Error dialog %Create a program from the RSC file Files produced by faceVALUE Structure of the LST file Updating a project 'Starting Face Value with commandline Understanding the RSC file Trees Mandatory trees Conditional trees Optional Trees Dialog trees User-window trees Objects Programming with faceVALUE !How the faceVALUE engine works "How to write clean GEM programs Hi ho, off to work we go Window iconification Working with windows &The RSC-file, objects and variables The ASCII-table dialog /How to use GDOS fonts and xFSL-fontselectors Getting keyboard-input The error-routine %'Wrinkles' - modules for faceVALUE The name and the goal Rules for wrinkles Documentation Face Value 2.0 flags Reference Reference - The resource file Reserved dialog names Sorting your dialogs Menu- and Dialog-Trees Menu - Extended type: 0 System - Extended type: 1 Background - Extended type: 2 Toolstrip - Extended type: 3 Toolbar - Extended type: 4 !ASCII-table - Extended type: 5 Mouseforms - Extended type: 6 Desktop - Extended type: 7 Progress - Extended type: 8 Busydialog - Extended type: 9 Iconify - Extended type: 10 PopUps - Extended type: 11 Alert - Extended type: 12 "Alert icons - Extended type: 13 $Alert strings - Extended type: 14 ListBox - Extended type: 15 $Animated icon - Extended type: 16 Code - Extended type: 17 'Non-modal dialog - Extended type: 18 'Prg.modal dialog - Extended type: 19 Toolbox - Extended type: 20 Changes to Dialogs &Dialogs with *no* window attributes Foldable Dialogs Desktop-Dialog Changed: System-Dialog Standard objects Boxtext Image Progdef Button Boxchar String Ftext Fboxtext (Menu)title Cicon Face Value special objects Frame Niceline Underlined text Checkbox Round radiobutton NumberScroller RadioTextPopup MenuTextPopup RadioImagePopup MenuImagePopup RadioListbox CheckListbox MenuListbox Shortcut button Shortcut string ShortcutIcon PointForward Shortcut boxchar PointBack Help button Help menu item AnimatedIcon AutoCompress Icon/Image CloserButton QuitApp New objects Sizer Object Toolbox popup radiobuttons Movable objects Drag & drop objects Objects with new features /Listbox: Autolocator added (hi, Manfred! ;-) Tear-Off Popups Animated objects Animated icons Object state Selected - OB_STATE bit 0 Crossed - OB_STATE bit 1 Checked - OB_STATE bit 2 Disabled - OB_STATE bit 3 Outlined - OB_STATE bit 4 Shadowed - OB_STATE bit 5 Extended object states: Object flags Selectable - OB_FLAGS bit 0 Default - OB_FLAGS bit 1 Exit - OB_FLAGS bit 2 Editable - OB_FLAGS bit 3 Rbutton - OB_FLAGS bit 4 Lastob - OB_FLAGS bit 5 Touchexit - OB_FLAGS bit 6 Hidetree - OB_FLAGS bit 7 Indirect - OB_FLAGS bit 8 Extended object flags Shortcuts in menu-entries Reference - Programming Global Global variables list window_array&(index&,x&) window_tree%(index&,x&) Reference - User routines Always user_var_index user_rsc_var_init user_rsc_interact user_rsc_draw_extra user_on_open user_on_exit user_quit_ok user_systemcheck user_gem_messages user_win_close_all Userwindows user_window_content user_mouse user_keyb user_win_close_ok User routines drag & drop user_dragdrop_init user_dragdrop_path user_dragdrop_accept user_dragdrop_loaddata 'Reference - Callable system routines Using windows win_open win_get_workarea win_set_infoline win_set_slidersize win_set_vslider win_set_hslider win_change_size win_keyb_scroll win_open_dialog win_close_all win_close win_set_title win_get_index win_send_redraw win_modal_enq Iconification win_iconify win_iconify_all win_uniconify win_uniconify_all Window cycling win_cycle Blitting image bitmaps vdi_bitblt &Offscreen bitmaps (mono, NVDI/EdDI) offscreen_open offscreen_close Allocate global memory mxalloc_global Fileselector support selectric_load$ selectric_check fileselector$ 0Getting information from the operating system appl_xgetinfo vq_extnd vq_vgdos get_cookie clip_bootdrive$ Alerts alert_standard alert_wind Blocking the screen/system aes_screen_lock aes_screen_unlock aes_clear_buffers Progress bar progress_open progress_update progress_close Busy dialog busy_open busy_update busy_close Virtual workstations v_opnvwk v_clsvwk Mouse mouse_wait mouse_form mouse_busy Load and save mono IMG img_load img_save #Sending GEM messages to yourself aes_internal_message Calling ST-Guide call_st_guide Installing a custom desktop desktop_new desktop_restore Using the GEM clipboard clip_write$ clip_read$ Working with objects rsrc_setup_tree xrsrc_gaddr rsc_ob_flags rsc_ob_state rsc_ob_check rsc_ob_hide rsc_ob_disable rsc_free_string$ rsc_free_image_vrt_cpyfm rsc_free_image rsc_set_new_menu rsc_get_code_adr rsc_ob_draw rsc_ob_xywh rsc_set_text rsc_get_text$ rsc_disable_menutitle rsc_find_menutitle set_cursor Read the keyboard state aes_get_kstate Drag & drop protocol fread dd_read_args$ GDOS and xFSL support vdi_load_fonts vdi_unload_fonts vst_alignment EVNT_MULTI loop evnt_multi_loop faceVALUE Converter 1.0 RSC library Example programs EX.RSC: IMG_VIEW.RSC faceVALUE history #Changes to faceVALUE version 1.1 Additions Changes, Improvements Bug fixes #Changes to faceVALUE version 2.0 Changes after Version 2.0 06.04.98 PL1 (HH) 07.04.1998 PL2 (HH) 08.04.1998 PL3 (HH) 08.04.1998 PL4 (MS) 11.04.1998 PL5 (MS) 17.04.98 PL6 (HH) 18.04.98 PL6 (MS) 19.04.98 PL6 (MS) 20.04.98 PL6 (HH) 22.04.98 PL6 (MS) 24.04.98 (HH) 24.04.98 (MS) Index